home *** CD-ROM | disk | FTP | other *** search
/ SGI Freeware 2001 May / SGI Freeware 2001 May - Disc 1.iso / dist / fw_socks5.idb / usr / freeware / etc / socks5 / eg / single_homed_host.example.z / single_homed_host.example
Text File  |  1999-04-16  |  4KB  |  89 lines
  1. File Name: single_homed_host.example
  2.  
  3. 1. Example - Single-homed Host with Kerberos Authentication
  4.  
  5. # This example describes a socks5 environment on network 163.201.56., with:
  6. # - one socks5 server, serverA running with kerberos authentication
  7. # - one socks5 client, clientA, running with Kerberos authentication
  8. #
  9. # This example assumes the socks5 client and server were built with
  10. # Kerberos --with-krb5[=path]. For more information about the krb5 option,
  11. # see the INSTALL and README files. 
  12. #
  13. # The client has one socks5 user, userA, who can issue all commands to any 
  14. # destination on the 163.201.56. network. 
  15. # The user must perform kinit before running commands to socks5 servers.
  16.  
  17.     ---------         ---------------         ----------
  18.    | serverA |       | 163.201.56.   |       | clientA  |  
  19.    |         |-------|  Network      |-------|          | 
  20.     ---------         ---------------         ----------
  21.                             |               userA:  unix user id
  22.                             |               userA@compA.ker.id: Kerberos user id
  23.                         -------------
  24.                        | Destination | 
  25.                        | any host on |
  26.                        | 163.201.56. |
  27.                         -------------
  28.                                  
  29.        
  30.  
  31. 2. Server Environment Variables
  32.  
  33. # You must tell the server where to find the configuration file. You can do so
  34. # in one of three ways:
  35. #  - Set the environment variable SOCKS5_CONFFILE
  36. #  - Include the socks5.conf file in the default directory, usually /etc
  37. #  - Build with the --with-srvconffile=path option
  38. # This example demonstrates using environment variables. The example path is 
  39. # arbitrary.
  40.  
  41. setenv SOCKS5_CONFFILE /socksdir/run/socks5.conf
  42.  
  43. 3. Server Configuration File socks5.conf
  44.  
  45. # This is the socks5.conf file for a single-homed host with Kerberos
  46. # authentication. socks5.conf must be in the directory specified in the 
  47. # socks5 environment variable SOCKS5_CONFFILE, or the default directory,
  48. # /etc/socks5.conf. The valid Kerberos id for userA is, userA@compA.ker.id
  49.  
  50. auth 163.201.56. - k
  51. permit k - 163.201.56. 163.201.56. - - userA@compA.ker.id
  52.  
  53. 4. Runtime mode
  54.  
  55. # To add debugging to any of these commands, add the following options:
  56. #               -d 2 -s
  57. #
  58. # To start the server in standalone mode on bindport 3000, at the 
  59. # command prompt, type:
  60. #               ./socks5 -b 3000
  61. #
  62. # To start the server in preforking mode on bindport 3000 with 8 child
  63. # processes, at the command prompt, type:
  64. #               ./socks5 -b 3000 -p -n 8
  65. #
  66. # If you built with threads, by adding the the --with-threads [=path]option, to
  67. # start the server in threaded mode on bindport 3000, at the command prompt,
  68. # type:
  69. #               ./socks5 -b 3000 -t
  70.  
  71. 5. Client Configuration File libsocks5.conf
  72.  
  73. # When the client and server are on the same network, it is most efficient to
  74. # omit the client configuration file and allow the client to connect directly
  75. # to the server. We include the configuration file for the purpose of  
  76. # demonstration.
  77. #
  78. # This is the libsocks5.conf configuration file for clientA. It should be in the
  79. # directory specified in the build, or in the default directory, usually /etc
  80.  
  81. socks5 - 163.201.56. -  userA serverA:3000         #userA is the unix user ID
  82.  
  83. # When you include a configuration file, set the client environment variable
  84. setenv SOCKS5_NONETMASKCHECK
  85.  
  86. # When you omit the configuration file, set the SOCKS5_SERVER environment
  87. # variable:
  88. setenv SOCKS5_SERVER serverA:3000
  89.